home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dmedia / playaifc.z / playaifc
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppllllaaaayyyyaaaaiiiiffffcccc((((1111))))                                                        ppppllllaaaayyyyaaaaiiiiffffcccc((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      playaifc, playaiff  - play an AIFF-C (or AIFF)  audio sample file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppllllaaaayyyyaaaaiiiiffffcccc [[[[ooooppppttttiiiioooonnnnssss]]]] ffffiiiilllleeeennnnaaaammmmeeee [[[[ffffiiiilllleeeennnnaaaammmmeeee2222 ............]]]]
  13.      ppppllllaaaayyyyaaaaiiiiffffffff [[[[ooooppppttttiiiioooonnnnssss]]]] ffffiiiilllleeeennnnaaaammmmeeee [[[[ffffiiiilllleeeennnnaaaammmmeeee2222 ............]]]]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _p_l_a_y_a_i_f_c parses AIFF-C (and/or AIFF) file(s) containing 8-bit or 16-bit
  17.      audio sample data (single channel, stereo, or 4-channel) and plays the
  18.      samples through the audio hardware.  playaifc reads the contents of the
  19.      AIFF/AIFF-C Common and Sound Data chunks, and skips all other chunks. The
  20.      hardware sample rate is modified, if possible, so that it agrees with the
  21.      value in the Common chunk. By default, the hardware sample rate will not
  22.      be modified if another program is using an output audio port at a
  23.      conflictly rate. The -r (for "rude") option will override this behavior
  24.      and change the output sample rate regardless of output port use.
  25.  
  26.      _p_l_a_y_a_i_f_c supports real-time decompression for G.711 mu-law mono or stereo
  27.      8-KHz, 16-bit data, and for G.722 mono or stereo 16-KHz data, 16-bit.
  28.      Note that the AIFF-C header identifier flags for these two compression
  29.      algorithms are currently recognized only by _p_l_a_y_a_i_f_c and other programs
  30.      written on top of the SGI audio file library. Note also that the Apple
  31.      proprietary compression schemes mentioned in the AIFF-C specification
  32.      cannot be decoded by SGI software. Consequently, AIFF-C files which are
  33.      moved between different system platforms should contain only
  34.      noncompressed audio sample data.
  35.  
  36.      If everything parses correctly, playaifc returns a 0 value when it has
  37.      finished playing the input file(s).  If there is an error, playaifc
  38.      returns 1.
  39.  
  40.      _P_l_a_y_a_i_f_f is a link to  _p_l_a_y_a_i_f_f which is installed for backward
  41.      compatibility. The two programs behave identically except that _p_l_a_y_a_i_f_f
  42.      by default changes the output sample rate (equivalent to _p_l_a_y_a_i_f_c with
  43.      the -_r option.
  44.  
  45. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  46.      ----hhhh   help: print a usage statement.
  47.  
  48.      ----vvvv   verbose: detail info to stdout.
  49.  
  50.      ----qqqq   quiet: suppress errors messages.
  51.  
  52.      ----dddd  <device>
  53.           device: specify the audio device to which to direct output.
  54.  
  55.      ----pppp   polite: before modifying the global output sample rate in the IRIS
  56.           Audio Processor, first check to see whether any other output ports
  57.           are currently active; if any other processes have open output ports,
  58.           don't modify the output rate
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppllllaaaayyyyaaaaiiiiffffcccc((((1111))))                                                        ppppllllaaaayyyyaaaaiiiiffffcccc((((1111))))
  71.  
  72.  
  73.  
  74.      ----rrrr   rude: change the output sample rate regardless of output ports in
  75.           use
  76.  
  77.  
  78. FFFFIIIILLLLEEEESSSS
  79.      Source code for _p_l_a_y_a_i_f_c is installed here:
  80.           /usr/share/src/dmedia/soundcommands
  81.  
  82. BBBBUUUUGGGGSSSS
  83.      To play back files containing sample data which is compressed using
  84.      G.722, MPEG, or Aware algorithms, you will need to run _p_l_a_y_a_i_f_c with
  85.      nondegrading high priority (this is especially true for stereo compressed
  86.      data).
  87.  
  88.      If being run as root, the priority is set to NDPNORMMAX which is the
  89.      highest normal process priority.  If run as a user, the process is set to
  90.      the highest non-degrading priority allowed by the system.  This parameter
  91.      is unfortunately by default lower than any normal process, but can be
  92.      changed using _s_y_s_t_u_n_e(_1_M).  Alternately, see the man page _n_p_r_i(_1) for
  93.      information about how to set custom priorities and time slices.
  94.  
  95.      _p_l_a_y_a_i_f_c doesn't restore the hardware output sample rate to its original
  96.      value when it finishes playing the AIFF-C / AIFF sample data files.
  97.  
  98. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  99.      recordaifc(1), apanel(1), aiff2aifc(1), aifcresample(1), aifccompress(1)
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.